GitHub Workflow Status Wall

A mobile-first dashboard that displays GitHub workflow status badges for your organization's repositories.

Features

Quick Start

  1. Install with uv:

    uv venv
    source .venv/bin/activate  # On Unix/macOS
    uv pip install -e .
    
  2. Configure:

    # .env
    GITHUB_TOKEN=your_github_token
    
    # config/repos.json
    {
      "organization": "your-org",
      "Backend": [
        { "name": "api-service" },
        { "name": "worker-service" }
      ],
      "Frontend": [
        { "name": "web-app" }
      ]
    }
    
  3. Generate and view:

    generate-badges
    # Open docs/index.html in your browser
    

Development

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Manual deploy
gh workflow run "Deploy to GitHub Pages"

GitHub Pages Setup

  1. Enable GitHub Pages in repository settings (select 'GitHub Actions' as source)
  2. Access your badge wall at: https://[username].github.io/[repository]
  3. Updates automatically every Monday at 00:00 UTC